package com.ruoyi.system.mapper;

import java.util.List;
import com.ruoyi.system.domain.Topic;
import org.apache.ibatis.annotations.Param;

/**
 * 题目Mapper接口
 *
 * @author ltr
 * @date 2024-10-22
 */
public interface TopicMapper
{
    /**
     * 查询题目
     *
     * @param topicId 题目主键
     * @return 题目
     */
    public Topic selectTopicByTopicId(Long topicId);

    /**
     * 查询题目列表
     *
     * @param topic 题目
     * @return 题目集合
     */
    public List<Topic> selectTopicList(Topic topic);

    /**
     * 查询当前教师的题目列表
     *
     * @param teacherId 教师ID
     * @return 题目集合
     */
    public List<Topic> selectTopicListByTeacherId(Long teacherId);

    /**
     * 查询已审核通过的题目列表（学生端使用）
     *
     * @param topic 题目查询条件
     * @return 题目集合
     */
    public List<Topic> selectApprovedTopicList(Topic topic);

    /**
     * 新增题目
     *
     * @param topic 题目
     * @return 结果
     */
    public int insertTopic(Topic topic);

    /**
     * 修改题目
     *
     * @param topic 题目
     * @return 结果
     */
    public int updateTopic(Topic topic);

    /**
     * 删除题目
     *
     * @param topicId 题目主键
     * @return 结果
     */
    public int deleteTopicByTopicId(Long topicId);

    /**
     * 批量删除题目
     *
     * @param topicIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteTopicByTopicIds(Long[] topicIds);

    /**
     * 更新题目审核状态
     *
     * @param topicId 题目ID
     * @param auditStatus 审核状态
     * @param auditOpinion 审核意见
     * @param auditBy 审核人
     * @return 结果
     */
    public int updateTopicAuditStatus(@Param("topicId") Long topicId,
                                      @Param("auditStatus") String auditStatus,
                                      @Param("auditOpinion") String auditOpinion,
                                      @Param("auditBy") String auditBy);

    /**
     * 更新题目的已录取学生数
     *
     * @param topicId 题目ID
     * @param increment 增量（+1或-1）
     * @return 结果
     */
    public int updateTopicCurrentStudents(@Param("topicId") Long topicId,
                                          @Param("increment") Integer increment);

    /**
     * 检查题目是否属于指定教师
     *
     * @param topicId 题目ID
     * @param teacherId 教师ID
     * @return 结果
     */
    public int checkTopicOwner(@Param("topicId") Long topicId,
                               @Param("teacherId") Long teacherId);

    /**
     * 保存待审核的修改内容
     *
     * @param topic 包含pending字段的题目对象
     * @return 结果
     */
    public int savePendingChanges(Topic topic);

    /**
     * 审核通过后应用待审核的修改（将pending字段内容复制到正式字段）
     *
     * @param topicId 题目ID
     * @return 结果
     */
    public int applyPendingChanges(@Param("topicId") Long topicId);

    /**
     * 拒绝修改申请（清空pending字段）
     *
     * @param topicId 题目ID
     * @return 结果
     */
    public int clearPendingChanges(@Param("topicId") Long topicId);
}